home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / compr212.zip / COMPARE.DOC next >
Text File  |  1991-03-26  |  9KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.         _________________________________________________________________
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                                   COMPARE
  31.                       BBS File List Comparing Utility
  32.  
  33.                                User's Manual
  34.  
  35.                                 Version 2.12
  36.                       Copyright (c) 1991 Edward Gause
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.      _________________________________________________________________
  65.                      Thank you for supporting Shareware
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.      ABOUT COMPARE
  73.  
  74.      Compare is a handy utility for comparing file lists obtained from
  75.      Bulletin Board Systems (BBS).  Optionally, you may also build your
  76.      own list of files that you already have. How many times have you
  77.      tried uploading a file to a particular BBS and received the
  78.      "File already exist" notice?  By using COMPARE, you can determine
  79.      what files a BBS has (or possibly one or two you may not have!) and
  80.      save some online time and frustration.  Hence, my reason for
  81.      developing this program in the first place!
  82.  
  83.  
  84.      SYSTEM REQUIREMENTS
  85.  
  86.      The following configuration is the minimum required to run COMPARE:
  87.  
  88.          IBM PC/XT/AT or Compatible with 256k
  89.          2 Disk Drives (5.25 and/or 3.50)
  90.          Any Adaptor Card
  91.          PC/MS-DOS 2.0 or higher
  92.  
  93.      A hard drive is highly encouraged if comparing very large files.
  94.      Several temporary files are created during operation and if disk
  95.      space is limited runtime errors may occur.  Also, a hard drive will
  96.      speed up read/write process during the file comparisons.
  97.  
  98.  
  99.      USING COMPARE
  100.  
  101.      Floppy Disk Users:
  102.  
  103.        1.  Place the diskette containing COMPARE.EXE in drive A.
  104.  
  105.        2.  Place a blank, formatted diskette in drive B.
  106.  
  107.        3.  At the "A:" prompt, type "COMPARE" (without quotes).
  108.  
  109.        4.  Shareware users will get a copyright notice screen is displayed
  110.            for 10 seconds.  Afterwards, press any key to continue to the
  111.            Main Menu.
  112.  
  113.  
  114.      Hard Disk Users
  115.  
  116.        1.  Make a sub-directory called "COMPARE" or whatever name you
  117.            choose.
  118.  
  119.        2.  Copy the program COMPARE.EXE to the newly created sub-
  120.            directory.
  121.  
  122.        3.  Type "COMPARE" (without quotes).
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.        ___________________________________________________________________
  131.        COMPARE Version 2.12                                         Page 1
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.        MAIN MENU
  139.  
  140.        The Main Menu is the heart of the program.  From here you may build
  141.        your own file lists,  compare file lists that you've downloaded
  142.        from a BBS or quit the program.
  143.  
  144.        Build File Lists
  145.  
  146.        Selecting this option prompts you for a filename to build and the
  147.        path where the files are stored.  The default filename is
  148.        "FILELIST.TXT" but you may choose another path and/or name if
  149.  
  150.        desired.  The default path is the current working directory.
  151.        Floppy disk users will enter "B:" here.  Hard disk users will enter
  152.        the path where they keep their downloaded files.  If reading from
  153.        floppy diskettes, you will have to repeat this process for each
  154.        diskette.  Hard Drive users should copy all their files to one
  155.        specific sub-directory (ie: C:\TEMP).  Once the new file is created
  156.        you can then delete all the files and remove the sub-directory
  157.        (refer to your DOS manual for creating and removing sub-
  158.        directories).
  159.  
  160.        Compare File Lists
  161.  
  162.        This is where the actual comparisons take place.  After selecting
  163.        this option you are prompted for the name of the files to compare.
  164.        If the files are located in the current working directory, all you
  165.        need to type in is the filenames, otherwise, input the path and
  166.        filename.
  167.  
  168.                EXAMPLE: C:\TEMP\MY_FILE.LST  or  B:FILELIST.TXT
  169.  
  170.        COMPARE will then begin to extract filenames from both lists and
  171.        store them in two separate temporary files.  It will match file 1
  172.        against file 2 and create a new file which will contain the file-
  173.        names that are not listed in file 1 (are you with me?).  Next, it
  174.        will repeat the process, creating another file contain-ing the
  175.        names of files not listed in file 2.  The new files will have the
  176.        same filenames but the extension "OUT" is added.  You can then
  177.        look at each file to see which files a BBS already has or that you
  178.        don't have.
  179.  
  180.        Sort Files
  181.  
  182.        Select this option to sort the output file(s) in alphabetical order.
  183.        COMPARE will search the current path for text files with an "OUT"
  184.        extension and read these files.  Once sorting is complete, You will
  185.        be notified.
  186.  
  187.        Quit
  188.  
  189.        Select this option to quit the program and return to DOS.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.        ___________________________________________________________________
  197.        COMPARE Version 2.12                                         Page 2
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.        ACKNOWLEDGEMENTS
  205.  
  206.        I would like to thank Craig LaCoss for giving me this "Assignment".
  207.        While developing this program Craig, along with Jim Smoot were very
  208.        helpful in the debugging and suggestion departments (hopefully,
  209.        they didn't miss anything).  Thanks for keeping me "chk" guys!  By
  210.        the way, Craig is the SysOp of MEGABYTE BBS (408) 883-0604 and Jim
  211.        is SysOp for the VIKING BBS (408) 883-2853.  Both BBSs are located
  212.        on the Monterey Penisula, CA.  Give 'em a call sometime.
  213.  
  214.  
  215.        SHAREWARE AGREEMENT
  216.  
  217.        COMPARE, version 2.01 is distributed has shareware, therefore, you
  218.        may make copies of the program and its documentation and distribute
  219.        them freely to others under the following conditions:
  220.  
  221.        1.  No fee or other consideration is to be charged for copying or
  222.        distributing the program without written permission from the
  223.        author.
  224.  
  225.        2.  The program and its documentation are not to be modified in any
  226.        form.
  227.  
  228.        3.  Commercial users are required to register their copies.
  229.  
  230.  
  231.        REGISTRATION
  232.  
  233.        If you like this program and find it useful, a registration fee of
  234.        $15.00 is requested.  For your convenience, a registration form is
  235.        included. (See REGISTER.DOC)
  236.  
  237.        Registration entitles you to the following:
  238.  
  239.        1.  A serialized diskette with the latest version available at time
  240.        of registration.
  241.  
  242.        2.  Registered users can request modified versions of this program
  243.        to search for any additional file extensions they desire. The
  244.        Shareware version searches for ZIP, ARC, EXE, TXT, LZH, GIF, DOC,
  245.        FLI, GL, COM, LST and MAC extensions.
  246.  
  247.        3.  You will receive continued telephone support for questions you
  248.        may have.
  249.  
  250.        4.  Notifications of future upgrades to this program.
  251.  
  252.        5.  Notification of new products developed.
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.        __________________________________________________________________
  263.        COMPARE Version 2.01                                        Page 3
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.        DISCLAIMER
  271.  
  272.        COMPARE is provide "as is" without warranty of any kind, either
  273.        expressed or implied, including but not limited to the loss of
  274.        business profits or information, business interruption or any other
  275.        loss arising out of the use or inability to use this software
  276.        product.
  277.  
  278.  
  279.        Questions or comments will be deeply appreciated.  If there's
  280.        something about this program that you like or dislike, please tell
  281.        me.  It makes me try that much harder.  You may contact me on my
  282.        bulletin board:   Images BBS (408)384-3658 or you can leave messages
  283.        on the following boards:
  284.  
  285.                          Viking BBS   - (408)883-2853
  286.                          Viking 2 BBS - (408)394-6584
  287.                          Viking 3 BBS - (408)384-1711
  288.  
  289.       All these boards have an excellent selection of shareware files
  290.       (including